Skip to content

Update dev services guide to use the new builder API#53545

Open
holly-cummins wants to merge 1 commit intoquarkusio:mainfrom
holly-cummins:update-dev-services-guide-new-api
Open

Update dev services guide to use the new builder API#53545
holly-cummins wants to merge 1 commit intoquarkusio:mainfrom
holly-cummins:update-dev-services-guide-new-api

Conversation

@holly-cummins
Copy link
Copy Markdown
Contributor

@holly-cummins holly-cummins commented Apr 10, 2026

Seriously overdue, but Claude and I finally got around to updating the main guides with the new dev services model, rather than having everything only in https://quarkus.io/blog/new-dev-services-api/.

  • Replace the deprecated RunningDevService pattern with the DevServicesResultBuildItem.owned() builder API introduced in Quarkus 3.25
  • Add Startable interface implementation example using GenericContainer
  • Document the owned() builder methods (feature(), serviceConfig(), startable(), configProvider(), postStartHook())
  • Add section on discovered() builder for externally-managed services
  • Update re-use guidance: centralized lifecycle via serviceConfig() instead of static fields
  • Add quarkus-devservices runtime dependency requirement

Deep link to revised doc: https://quarkus-pr-main-53545-preview.surge.sh/version/main/guides/extension-writing-dev-service

Claude did the initial copy-pasting and I hand-rewrote.

@holly-cummins
Copy link
Copy Markdown
Contributor Author

Marking this as draft because I want to edit by hand

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 10, 2026

🎊 PR Preview 1778eab has been successfully built and deployed to https://quarkus-pr-main-53545-preview.surge.sh/version/main/guides/

  • Images of blog posts older than 3 months are not available.
  • Newsletters older than 3 months are not available.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@holly-cummins holly-cummins force-pushed the update-dev-services-guide-new-api branch from 7b5ba38 to 3af8eed Compare April 14, 2026 11:26
@holly-cummins holly-cummins marked this pull request as ready for review April 14, 2026 11:28
@quarkus-bot
Copy link
Copy Markdown

quarkus-bot bot commented Apr 14, 2026

Status for workflow Quarkus Documentation CI

This is the status report for running Quarkus Documentation CI on commit 3af8eed.

✅ The latest workflow run for the pull request has completed successfully.

It should be safe to merge provided you have a look at the other checks in the summary.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant